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EDITOR’S PAGE 


OK... It’s a new year...So what... 
So...HAPPY NEW YEAR 


Already my new year is better. Last year was begging and a couple of takers. | 
This year starts with a new entry to that select group with Larry Bergan’s article | 
on page five. | hops that it is a communicable disease to be caught by several of | 
the brighter lights in the club. 

As an update to my article on WordPerfect | would like to tell you about an 
evening this last week; I got Larry's article on Cyber Products that was done in a. 
nondescript word processor then down loaded an review from Genie done in ST 
Writer. After trying to import both of them into Pub. Pard. | gave up in 
frustration. About that time Arletta checked the mail box and brought my | 
updated WordPerfect disk into the den. Within a half hour | had Converted the 
Strange-O from Larry and Search-and-Destroyed my way through the ST Writer | 
file and had both of them loaded. Alf it takes is to go to the screen section of WP 
and open the character mapping function then load the strange characters into 
the control or alternate set. Then when the search prompt comes up hit the alt. | 
or ctri. + the key they have been tied to and they are there on the prompt line. 
Having loaded the cannon it is time to search and destroy. A good job on WP's | 

art 


This is also the way to write in mast Romance Languages; Just set the alt. set 
for the language different characters of the language you are using and then 
press the corresponding alt. or ctrl. key. The prg. automatically inserts the 
foreign character. 

The constant hassle over one club or two clubs and who left who where is so 
tiresome as to be an irritation in-and-of itself without all the imagined hurts |" 
reported so often in the various journals, | have as friends many who are still 
vary tied to the eight bit world and would not have bought an ST until the 
emulater became refined enough to run as well as in the native environment. 4 

These folk can, at a glance,tell if a piece is about the eight bit or the ST. [| count | 
myself as one of the people who feel cheated when | have read half or more of an 
article only to find that it is about a machine | know nothing about. 

__As the new developments come on line the ST will be (left-out} the same as the 
eight bit feels they are now. At that time | hope that the members who decide not | 
to invest in the new equipment will not become Albatrosses hung about the neck 
of members who have just paid good money and need good help not old reruns. 
if their STs were dear to their hearts, as many eight bits are to ST owners, they | 
will keep a dual interest and may form SIGs within STUN. All of us should know 
though that as soon as the single item owners become a large enough group they 
will seek their own conference and form their own organization. Lets be gentle | 
folk and wish them well. ; | 3 7 | 
There is something personal in this plea for peace. As editor of a ST oriented 
magazine | must scan through a virtual mountain of Newsletters and Journals 
monthly and by the time it is all through | wish more clubs had separated their 
STs from the others. 7 

The articles on the C language in this issue are reprints from the earliest issues 


+ of ASTUN before it was sent to club members. They are by Ralph Porter and we 


hope to convince him of the value of continuing the series in the next months. 
THUNDERPEN 
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i's a new v yeas and one of my resolutions isto make this | 
| cluo great! However, 4 and my stati can ‘t do it all by | 
ourselfs. We need YOU! The only way this club canbe | 
useful to all of it $ members i is if each and everyone oft us | 

support it. 





And what is : suppor you ask? Well, aunliet is not just 
| paying your yearly dues. ‘Support i is the willingness to help 
your fellow members. This willingness can be shown in | 
| Many ways. — , | : 


| You could demo your. Bie: software package in ie 
monthly club meeting and/or write a review of it for the 
club newsletter. You could give your suggestions for the 
improvement of the club, the newsletter, or the BBS, You 
could offer to lead a sig to teach other members how to | 
use and benifit from certain software packages or 
| languages. 


Just remember one thing. This club was started by people 
| just like you who wanted to expand thier knowledge of the 
computer by teaching what they know to others while 
learning what you have to teach at the same time. 


| Let's all make this a great year for the étuibi by naemating 
and SURROFING in ae way we can. To receive ey must} 
also give. 7 ‘s tesslt ; 


: | would like to thank the following people for thier Pauppoet aa 
by bringing thier computers to the December club meeting : 
So we could have the Midi-Maze competition. | 
Larry Bergan Brad Davis 
Bob Frederickson Chuck Johnson 
~ Tony Murillo ni Porter 


! dim Hepworth | 
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ANTIC CATALOG CYBERMATE PRODUCTS 


areview by Larry Bergan — 


Animatian has been around for a jong:times now. Long enough that aimost 
everybody has a basic idea of how it works, but not long enough, in my opinion, 
far anes to still not be a little bit mystified by it. More than any other art, 
animation allows people to actually illustrate what could a be imagined before. 
But, even something this wonderful was not immune to the ravaging. of those 
eager to make money from it, don't get me wrong, | don’t think there ts anything 
wrong with making a living in this manner. It's a lot of hard work to do even a 
short animation. Besides, Some of the best animations seen today (Including, of 
course, computer created animations), are on commercials made for television, | 
just feel that this art could, at least sometimes, be utilized in a more dignified 
manner. Camputer animations in particular have been trivialized by this kind of 
application. The kinds of things | would like to see more of in the way of 
computer generated images, would be something made with the care that went 
into the movie 2010. The images in this movie were so good, you couldn't tell | 
that some of them were generated by computer. Your mind was on the plot of 
the movie, instead of haw phony the special effects looked. | also like the 
introduction sequence for the Amazing Stories series. . 

On to the Antic Cyber library! Obviously, you still can't do computer graphics 
comparing with the ones seen in some movies at home in your spare time, but 
for the price of a used car, anyone willing to put a little effort forward can produce 
very nice graphics as good or better then those seen on many local television 
newscasts. An Atari ST series computer with one megabyte installed gives you 
plenty of room to let your imagination run wild, (however, more memory allows a 
ot more flexibility). | consider a double sided disk drive to be a great asset, 
however, it is not necessary. The three main products available at this writing 
are Cybermate studio (including CAD-3D), CyberPaint, and Cyber Control. Also, 
vatious programs are available in the public domain and through the Antic 
Catalog, (included in issues of Antic magazine) that will enhance the capabilities 
of at least CAD-3D. The people at antic claim that these programs will never 
become obsolete, due to the constant updating and including of accessory’s that 
can be used within CAD-3D. | have even read that someone is working on 
something that will allow the use of Spectrum 512 graphics. | can’t say to what 
extent this will be possible, but the prospect is very exciting! These programs are | 
already portable to other art programs, making it unbelievably versatile. Also, 
Cyber Studio, and CyberPaint are completely “stand alone” programs. | 

ff you. ever enjoyed making things out of wood or similar materials, you will love. 
CAD-3D. Objects can be “extruded” (sort of cut out) or “spun” (similar to a 
lathe). Then you can use the “join” feature to either connect two objects 
_ together to form a new object, or cut one objects shape out of anothers to allow 
making shapes that can’t be “extruded” or “spun”. The "join" function must be 
used with cara on more coniplex objects, since you might lose control of the 
computer for long periods of time.WLAD-3D is easier to use with the monochrome 
monitor because of the higher resolution, but the updated 2.0 or higher versions 
support the color monitor so well that | have a hard time deciding which to use. 


| You can give each object a color or range of colors. Also, backgrounds can be 


loaded from art programs, but some planning is needed to make your 3D objects 
stand out in front of it. Also, CyberPaint only works with color creations. — 
CAD-3D uses GEM conventions such as drop down menus and windows. One 
window is called the camera window and will allow you to view your objects from 
any direction, but will only point towards the center of the "universe". However 
ou can move objects around using three other windows that can be set to side, 
_ front, top, etc.. These are the windows that allow you to do animations of 
individual objects or position your objects in relation to each other. s 
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_{ Sometimes you will wonder why something looks odd, to find that it is out of line in * 
| one of the windows. These windows alse allow you to shrink or expand one or all | 


of your objects in any direction. Four different buffers are Srovided for objects,. |. 
allowing you to select which and how many will be shrunk or expanded at the | 
same time. For instance, if you make an object that is a lot bigger then the | 
others, you can put it in one buffer with the others, and in one by itself and go 
between them wnile changing it to see if it is the right size or in the right place — 
nice feature). All of the objects can be moved or changed in every possible way. | 
here are even four different light sources that can be moved with the mouse, 
although | am still unable to figure out exactly how fo use them. . | 
Objects can be drawn in one of five ways in the four black and white windows 
that are in use. Wire frame is bast for drawing things quickly and shows all lines 
used in the objects (this is obviously a very complex program and even with the 
speed of the ST, time is needed for compiex scenes). Another mode hides the | 
lines that would not be seen in the solid objects. Another draws objects with lines 
but also shades objects in accordance with the selected lighting, while another | 
draws objects shaded, but without lines. All of the windows can be set . 
independently to draw in one of the above modes or not at all. The last method 


| draws objects displaying lines that actually show how the objects are constructed 


(from triangles). Scenes can be drawn in one other way, but | wouldn't call it a 
window. This is where color and full screen, (or full screen stereo) renditions are | 


| made. These can be drawn in the ways above, or in what is called a final mode 


| et show through on the other modes. 
i 


where the image is drawn very slowly to poe surfaces which sometimes 

oo bad. Sometimes I prefer to have | 
sharp lines drawn around objects and this mode doesn't allow that. However, 
these drawings can be saved as picture files and touched up in other programs 


| such as Degas or CyberPaint. 


A review in Byte Magazine has said that the early version of CAD-3D was ane 


_ of the best programs written for the Atari or any other microcomputer, but now, 


the animation capabilities have been exploited, and even more accurately 
rendered 3D objects are possibie (not easily but they are working on it), with the 
Cyber motion control language. This is a language much like basic that is 
available from within CAD-3D as an accessory and will allow you to program | 
CAD-3D to do anything from Coy objects, to animating them while you goon | 
about other business. Granted, much planning and thought | 

has to go into a complex animation before programming, but anything that offers 
the flexibility and creative lacence that this does, has to be somewhat difficult. 
That’s not to say that it would be impossible to accidentally create some real nice 
sequences. Everqthing possible has gone into making the tedious aspects of | 
animation into an enjoyable experience. Of of the nice additions to CAD-3D 


| allowed by this accessory are the two extra cameras thal can move much more 
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freely than the one provided in the mother program. You don’t need this program 
to create animations from CAD-3D, but it definitely allows you to do things that | 
would be impossible without it. Since this program creates large animations out of 
compact computer code, called CTL files, very large animations can be sent over 
phone modem gnly accra that file, a picture file and a CAD-3D file (You 
may not even need the CAD-3D file if your objects are created within Cyber | 
Control}. Also, CFL files can allow automatic creation of monochrome, stereo, or | 
regular color animations, with only slight changes fo the code. The only bad thin 
| can say about Cyber Control, so far, is that it uses memory that could be use 
by CAD-3D, so some larger files wont fit. Since this program works more fully 
with version 2.02 of CAD-3D, a free upgrade (You don’t even have to pay 
shipping) is available by sending the original disk and registration for Cyber 
Control fo Anite. ee are» ne 
After you have created an animation sequence using CAD-3D, with or without 
Cyber Control, then you can chain these sequences together and further enhance 
them with the Cybermate portion of the CAD-3D package. | 











"oe 
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This program comes on a separate disk, and allows you to change the timing, add | 
or clone parts of the animation, do dissolves, add sound, change colors, and 
many other things including using color cycling information saved with DEGAS 
pictures. To add sound, it is best to have the G.1.S.T. sound editor (Also 
available through the Antic Catalog). As with Cyber Control, this also is an actual 
programming language. This one is more like Forth than Basic, but don’t be 
scared off by this. Though it helps to have an understanding of Forth or. Basic to | 
utilize these languages to their fullest, it is certainly not required to make some 
really fantastic animations. | 7 | : 

Last in this review, but not least, is the CyberPaint program. As mentioned 
earlier, this can be used to touch up poorly rendered CAD-3D solid line drawings 
or animations, but it can also be used to touch up or create from scratch, entire 
call type animations! This program is a full featured art program with some 
features you may have not seen yet. This including the fact that you can do 


animation, makes this a very entertaining program. Images and animations can 
| be loaded from many different sources. [especially enjoy being able to load DLT 
files created from CAD-3D and then save them as SEQUENCE files, which take 
up about 50% lass disk space. This way, three or more detailed animations can | 
be placed an one double sided disk and run cantinuously, each with different 
settings on speed, efc.. The drawback to sequence files is that the take longer 
= ee and save, but don’t worry, they can always be changed back to DLT 
ormat. | Se 3 

One thing that makes experimenting with animation so easy is the blue function. 
| This allows you to draw a line in one frame in a certain color, then go to the next 
frame and see the same line or ea displayed in another, (usually blue), 
color, Then you can draw over this blue image using the original color and 
change it slightly to make it move or change shape. This change is recorded and 
the blue image.disappears, then you do the same thing over several frames. Run 

it back, and the magic of animation makes the image “come alive". 

A lot of automatic functions allow you to manipulate the images you draw or 
toad from other sources. You can use one of three modes Frame, Sequence, or 
All) to determine how many frames in the entire animation will be affected by 
these manipulations. You can ,for instance, over 39 frames, make afullscreen | 
picture rotate 3 times around an axis set by gou, shrink into infinity, move | 
smoothly along a path set in one of four ways, afd spin on the x,y or z axis, all at 
once. The bi ger the range of frames set, the smoother the animation. It's a | 
sophisticated k function module, but it warks on animations. The bad thing 
about it is that, more than anything I've done on the computer so far, this makes | 
me realize how much | want more than one megabyte of memory inmy ST. | 
Many of these multiframe manipulations end with an out of memory message. | 

Not only was this ee written by the same person who wrote the Aegis | 
Animator for the ST but it will allow loading of Aegis animations for further 
anhancement. As far as | can tell, Aegis animations are more memory eificient, 
but can't come close to the incredible speed of the Cyber type animations. {long 
hoped that it would be possible, but never reaily et oe that full screen 
animations could handle this type of speed. It makes simple cartoons so easy, 
that you have a hard time believing that you made them. But don't lose all your | 
respect for Walt Disney yet, detailed animations are always a lot of work, you | 
don't breath life into imaginary characters by scribbling, but ["ll bet alot more | 
people would have tried it in the past if it had been this leisurely. Also, at the cost 
of materials for conventional animation, (thousands of sheets of acetate, paper, 
paint, motion picture cameras, lights, film, — not to mention the unbelievable | 
amounts of time required to paint all those cells, who knows, maybe some real | 





Sastre unt ed AOSHI 


talent will come of this new ability to try our own hands at animation! 
: LARRY BERGAN > 
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‘ AN INTRODUCTION TOG. -») 
» Ralph Porter 


| We will be presenting the C programing language. This is the language used 
_ for development of mast of the programs currently available on the ST computers. 
| C is a language that has developed over the years to become one of the best 

; systems languages there is. Many operating systems are now written almost 
| entirely in C. The reason for this is because C is a relatively low level language 
; and makes available to the programer features that are normally available only 
| to assembly language. It is. one of only a few languages that let the programer 
directly address registers in fhe c.p.u. and to allow access to pointers... All 

languages use pointers but most are handied only internally. C lets you 

manipulate pointers as well as variables and data. If you don't understand what 
| mean when discussing pointers you'll find more information in a future issue of 

this newsletter. We'll have to cover some other basics first. 

C offers a structure format that is consistent with modern programing 
techniques. [i was first implemented using the Unix operating system on a Dec 
PDP-11 computer by Dennis Ricthie. It is now available on almost all serious 
computer systems. The unix operating system was then rewritten in C with only a | 
| wang jew lines of code in assembly language. ? 
he C language is unique in that it offers no input or output facilities within 
; the language itself. This is nothing to be alarmed about as it allows the use of 
| many external functions. A standard library of functions include the most needed 
| 1.0. routines. If you have one that doesn't exist you can write your own and add it 

to the function library. i | set 3} 
C has several forms of looping within programs. Programs are written in a 
| straight forward approach. The use of statements like the basic goto is highly 
; discouraged even though a form of goto is included in the language. Well discuss 
} this also in another installment. : : 
CG is a relatively smail language. lt also lacks operators to process strings. 
It does no garbage collection and as previously mentioned it contais no read or 
write instructions. ; id ef ne 
All these thing can be accomplished with functions. As a function library is 
built up C can become a high level development system. The C language grew 
out of the languages b and bepl. It has several of the characteristics of these 
languages but ts not a dialect of them... 7 pied 
he operating system and the Gem environment on the Atari ST computers 
were largely written in CG. The C compilers presently available include | 
| functions to directly interface with the operating system. C is not aperfect | 
language but this author feeis it is one of the best development tools avaiiable at 
the present time. lf you have used Pascel or one of the other structured 
languages converting to C will be easier. If you are a Basic programmer then you'll | 
have to also learn the concepts of structured programing. The hardest part of C 
for me was learning the required syntax for the commands and structures. 
Another major difference between C and basic is the way C treats variables. 
Many Basic systems do not require the initialization of variables. Basic on the 
Atari machines did require this so your a step ahead in getting started in C. | 
The difference is that in basic ail variables are global to the entire program. In C it 
| is possible to do this but highly discouraged. Having all variables global is a real 
source of hard to find bugs in programs. The convention in-C. actually makes it 
easier to produce bug free programs. A variable can be local to a function. A 
function would relate to a subroutine in Basic and Fortran or a procedure in 
Cobal. lf can be static to a function which means it is unique to a specific 
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function but retains its value. It can be unique for a specific file or for an entire 
program. This may seem confusing here but as you proceed in C you'll see how; 
this really enhances the language. | 
- © can be written like Basic as a full program ar it can be written in small 
building modules called functions. This is the normal way to write C programs. 
Each function or subroutine is written to accomplish a single task well. [t is then 
combined with other functions to complete a program. Once a function is written; 
in-C it is then available for use by all future programs. | 


_ We will see at a later date oe how powerful this is. Information is passed to 
functions as either a copy of the data or the address the data is located at. The 


| address of the data is called a pointer. 


C is one of the better languages for porting programs from one machine te 
| another. ff programs are written within the definitions of C as defined by Brian 
| Rea and Dennis Ritchie in the Book The C programing Language 
published by Prentice-Hall then ent the pragram from one computer fo 
another can be done with very little difficulty. An example is applications using 
GEM. Even though the processors inthe Atari and The [.B.M. are not 
campatible, source code programs written in C can be compiled and run with 
little or no change on the other machine. — 5 | | 
| think this is enough introduction for now. This column is the first 
installment of our C programing tutorial. | hope this is enough to interest you in 
learning this language. Each tutorial installment will include one or more functions 
that will help to expand your function library. Later we'li combine the functions we | 
_ develop for performing complete programs. ee 





A C PROGRAMING EXAMPLE 
nT bes by Ralph Porter | -e0rbe% 


In prior instalments of this tutorial we discussed various aspects of C 
3 ee theory. in this instaliment we will present afew C functions and | 
explain their purpose along with a detailed description of how they work. Future 
installments will most fikely be less detailed. ; - | 
The code presented is for the Atari Development System, however few if any 
changes should be needed for a different compiler. No floating point or 
structures are used in this installment. : = 
‘The code chosen may not be the most efficient but it represents several 
important programing concepts. The line numbers in the program listing are for. 
reference only. C does not use line numbers. If you type this code into your 
computer do not type in the line numbers. Lines 1.and 2 of the source code are | 
preprocessor include statements. They tell the compiler to include the 
specified files in the compilation process. The first file stdio.h contains macros 
for standard input and output. Almost all C programs include this file. 24 
The second osbind.h includes macros specific to the Atari operating system. 
This includes bios, extended bios and gem calls. : | 2 
tine 4 contains a define pre processor statement. In this case it defines a 








constant which reptgsents the maximum length of.a string the program will |. 


allow. The rest of the define statements are defining macros. When the 


compiler sees a defined constant or macro the code or value to the right of the 
defined key word is substituted for the key word itself. It can be used to | 


simplify constants by giving them a name, and to shorten keystroke as is the | 


case with macros. 
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In the example on line 7 averywhere the programer inputs the statement 
kip the statement actually complied is Ceonin{). One may wonder the 
value of this. It may in some cases seem meaningless. In others like in lines. 


12 and 13 it saves the programmer numerous keystrokes. In many cases -a | 


macro is faster than calling a function because the actual code is executed in 
place. Our example on line 7 is for a different reason. — | a | 

Notice the undefine pre processor statement in line 6. The function getchar({) 
is defined in the stdio.h file. The problem is it does not always work properly 
due to a bug in the development system compiler. This is also true for gets() 
which is atrue function. The gem call Ceonin(} works fike the Seen function 
should. Using it here in this macro allows the programmer to write coda that js 
iransportable to compilers that work correctly. in the working compilers the only 
change needed will be to remove the related define statement from this source 
file. The gets() on line 8 replaces the call to gets{) with a call to Getstr{) a 
function that we will shortly discuss. This replaced function again. works like 
gets() should but does not work in the development system. One other defective 
unction is scanf(). The fix for it is not as easy dué to the complexity of the 
function. To get around it read in a string with the gets() calf and then do a 
sscanf() function on the resulting string, | ee 

The problems discussed in the development System standard i/o library are 
caused because the C language expects a new line character {control j) rather 
than a return io end the fine. The C run time library should have fixed this 
problem but it didn't. The standard functions due to this error do not return 
canirol to the calling program when return is hit. To return control on the ST you 
must hold control down while pressing the j key. The macro replacing 
getchar(} and the function call replacing geis() fixes these problems so the 
standard return key can be used, a , = 

Lines 9 through 13 are true macros. These macros are-normally contained in 
a file ctype.h. This file was missing in early versions of the development system. 
We elected io define them here to show how macro can be used. The actual 
macros in the ctype.h file are different. This is because a Structura is used to 
define character types. The final result however is the same. In our case they 
are stand alone macros. ee “di Be isteni wite . 

The purpose of the first three are similar. They perform a test to see if the 
character under test is a digit (number) or an upper or lower case character 
respectively. These macros return a true or false condition when executed. The 


macros on lines 12 and 13 have an internal call to another macro... They return - 


the character either as tested or else converted to the opposite case, dependin 
on the result of the internal macro call. This macro uses the. conditiona 

operator "?:". This operator reads like this. ff the condition an the left of the "2" 
is true then perform the operation to the right of the “?" and the left of the ":". If 
the test condition is false perform the operation to the right of the “-". Itis a 


form of if then statement and is very useful if only two choices are present. 


The function defined in lines 15 to 22 fixes the problem with the gets() function: 


described earlier. As in all C functions a function name is given along with the 
variables it expects. Here the function name is geistr and it expects one variable. 
The second line tells us it is expecting a pointer to a character or character string. 

The "*" means a pointer to int. The definition phase as used here. {t could also 
‘mean the contents of if used outside of the definition. Line 17 the "{* delimits 
the start of the function. The "}" at line 23 is the end of it.. Line. 18 defines a 
character array of 82 characters. An array of characters is referred to, as a string. 

The constant MAXLEN defined back on line 4 is 80. Line 19 places the number 
80 into the first element of the String. This is required by the gem call we are 
about to make. The second element of the String will contain the actual number 
of characters returned when the call is returned. Forour purpose here we will 
ignore this element. __ ; 


Rib men tet, 
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The third through n‘th characters is the actual string returned. The call we use | 


_. to accomplish this is Cconrs(). This function works similar to the way | 
| aoishouss except for the extra two characters needed to beginithe string. The 


ast line of the function copies the returned string into the variable pointed io. 
bys. gre" return to the calling routine the keyboard input is effectively 
returned. 7 | ee 
Back ta the define statements. They have all been explained now with the 
exception on line 5. getkey() will work similar to getchar(). The difference is that 
no echoing of the character takes place and that no character translation 
takes place. This function will let you look for keys that are normally 
intercepted by the operating system such as (control c, s and q). We have 


included this macro for your use. it is not used in our examples today. 


Lines 24 through 113 contain a series of functions that make Up a simple utility 
designed to make data entry more user friendly. | , 

When entering a date most-computer programs require that you follow an | 
exact method when inputting. This utility removes the need for specific 
formats. Regardless of how you input the date the resutt is the same. The 


feturned date is the format that the programmer needs. The only rule is that the 


date must be input_in a non- military fashion. This means month first followed 
by day and year. These are all legal input, (January 11,1951 Jan 11, 1951. 
VIVS1 1-11-5101. 11 1951). Many other combinations and punctuation may 
be used if desired by the inputter. All examples used return the date in the 
TORM St UE 1B) mnie sadmet 
in addition to making it easier to input dates this function does a check to 
insure that the entered date is a valid date. [f an invalid date is entered it 
reprompts you until you enter a valid one. The program properly handles leap 
ear. Whether you have use for this utility or not is not important. The 
important thing is that several programing techniques will be illustrated. Bore 
efore wa get to the specifics of this utility we must discuss how to call it. In 7 


an earlier tutorial we noted that -all C programs must contain a function 


main(}. In our sample this is at line 116.. Note that the placement of this function. 


_is not important. It may be at the beginning, the end, or anywhere in between. 


What is important is that it is always where the program will begin executing. 
We will now walk through the function main(). Before we do however we 
must point out that the stalement on line 24 declares a global variable. The 
variable is a pointer to an array of strings that contain the months of the year. ht 
is initialized in this statement. Because this is defined outside of any function 
this is a global variable and is available any place in the program. Had we | 
defined it as a static variable at this point it would only be available to this source | 
file. ‘Note that two lines ara used in initializing the variable. C is a punctuation 


. delimited language. Code can easily be spread over several lines. The symbols 
"{" and "}" are used for delimiting. nS | : 


Getting back to the program the first thing we do is define variables c, send | 
date as characters. c is a single character, s and date are pointers fo a character 
string or a character array. All arrays define pointers even though the **" pointer 
symbol is not used. We then define integer variables i, month, day. and year. | 

hese are all automatic variables and none of them are initialized. This 
means they may contain unwanted data, {t also means that they will go away 
when the function they are defined in finished executing. Had we declared them 
as Static then they would automatically be initialized to zero and would retain 
their value whenever the function containing them was called. Static variables 
have no advantage here so we did not use them. We only used one global 
variable so we could illustrate some variable passing to functions. One should be 
careful in the use of global variables as they can be a source of hard to find 


_ program bugs. 
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Line 120: and 121 call the most common C function. Here we simply print the 
quoted strings to the oufput device or C.R.T. The "In" is the new line character 
and must be included if we desire one. Line 122 calls getchar(}. In our program 


it actually calls Cconin() because of the earlier defined macro on line 7.. This 


function returns a single key as you prass it. It echoes the key pressed to the 
terminal. Line 123 shows the conversion ability of printf. : 

The% indicates a variable, in this case d, representing a decimal integer. The 
item to be output is the variable c that was previously input. The decimal 


value of a character is its ascii value. Lines 124 to 127 demonstrate the 


working of the gets() macro. {t asks you to input a string ended with a 
cartilage return. {ft then uses the c function strlen() to tel you how many keys 
au pressed. Notice that this function is nested inside o the printf function. 


This capability is one reason C is such a powerful language. Not many 


languages allow this form of nesting. —— moet 
é next line calls the first. of the functions making up the getdate utility.. [t. 


shifts execution. to line #40. It passes to this function the address of the date [| 


variable. (Pointers store addresses). The function is expecting a character } 
pointer and that is what we sent it. This function prompts the user forthe | 
date and places the users input into the date variable. It then calls the 
function checkdate() which will reformat it and verify its a valid date. Again the 
date pointer is passed. Within the function three automatic variables are 
defined. h These variables (month,day,and year) are not the same as the 
variables with the same name in main. Remember autom aticvariables are 
local fo the function they are defined in. This function first calls the macro 
isdigit(} passing it the first character of the date string. lf the first character is a 
number between 0 and 9 the sscanf function -is called placing the value f the first 
number into month variable. sscanf() like printf can convert dafa types... in this 
case a string is “converted to aint. AS 4 | Jat 

¥ the isdigit test failed the else statement is executed. Note only one line of 
code or instruction followed the if. No delimiting is needed if only one instruction 
is to be executed in comparison and looping tests. When more than one item is 
to be performed then delimiting must be done as with this else statement. All 
commands within the braces will be executed. cee ag Pe - 
The next three instructions (lines 46-48) force case conversion of the input 
String to match that of the test strings define in fine 24. See gia 

A isop is then executed up to 10 times looking for a match. The stremp() 
function checks two strings to see if they are aia We use the strnemp() 
function that compares two strings to the specified ength for equality. Here we 


test only the first three characters. {f the first three characters match the break 


Statement is executed which dumps us out of the loop, ff they don't the loop is 
executed again. The for statement limits the loop to 12 passes. C does not use 
anext statement. All oS for a for loop is contained in the for statement. 

A for statement has three parts. The first allows setting variables to assigned 


values. More than one variable may be assi ined by delimiting them with 


comas. The parts of the for statement must be delimiter with semicolons. The 
middle of the loop contains the exit conditioner test statemant. In this case the 
test is made to see how many passes took place. The last item is what to do at 
the end of each ieee before the next one starts. Here we increment the test 
variable. The ++ inC is the same as saying X=X+1 in basic. ee 

_An interesting sideline is this, If the +4 appears on the right of the variable 
then the incrementation takes place after itis used. if it precedes the variable 
the incrementation takes place before it is used. : ers 

_ All arrays in C begin with element 0. That.is why we now increment the month 
by one so it will match the calendar month. At this paint if a valid month was 
entered it will be in month. {f not month will contain 13. =— 


aaa aetna ecient ho tn tach roe Gea eon TTY 
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Line 55 calls the function nxt_fid() and passes it the date pointer. Note the 
underscore in the function name. This is used to make variables more 
descriptive. Use it where a space would normally be used. 

The purpose of nxt_fid() is to remove any data that has already been 
obtained and to remove punctuation from the test string. Note we passed the 
date pointer but the function expects a pointer tos. The data passed to C 
functions is always a copy of the original. The original is not changed. 
Passing pointers or addresses allows the program to change the contents of 
those pointers effectively changing the data. [If no pointer is passed the 
original data cannot be changed within the function. This s within the 
function now contains the save value that is in the date variable outside of the 
function. This feature of C eliminates many errors that creep into languages 
like basic that define their variables globally. ; 

We first declare the integer variable i and assign it a value of 2. Then we 
execute the while statement. While is another form of looping. The 
statement executes until the test condition is false. The “!* or not operator 
reverses the test results. It reads while the ith element of string s is not a digit 
execute the loop. When a digit is reached the loop exits. We then copy the 
string with the strcpy function. The first part of the string is lost. Since sisa 
painter the contents of the date string that was mapped into s is changed. The 
reason this function is a function is that the program uses it twice. By making it 
a function the code need not be duplicated. 

if you are confused about variable passing you may need to review past 
tutarials or consult a book on C. A function can return one value. If more than 
one is needed then it must be done by passing pointers. 

After finishing the nxt_fid{) function we return ta the line following its call. We 
now read the day with sscanf, again call nxt=fid and then read the year. Note 
the “$" in the sscanf calls. The °$" means the address of. sscanf() can 
assign many variables so the addresses or pointer must be passed. sscanf() 
returns the number of variables read. We are ignoring this in our routine. 

The “=%" in the next line may need explaining. This. line is saying (year= 
year % 100) where % means modula or remainder. This farces a four digit year 
info a two digit one. The next several lines do error checking. We use a 
switch() stafement. The switch is a ee if else derivative. We first check 
for a valid month and then a valid day. Hf the month is February we need to. 
make more checks. If it's February and the day is 29 we need to know ff it’s 
leap year. If its not February we need to know if its a month with only 30 days. 

Ail checks for this take place here. If any test fails the error routine is 
executed. The function date_err{) prints the reaso@ for the error and again 
cails the getdate() function. The process continues until a valid date is input. 

Note the recursion. getdate(} calls date_err() which in tern calls getdate(). 

Recursion can be used to advantage in C. In some cases a function may call 
itself. In a future tutorial we will probably demonstrate its use. a 

With a valid date entered the sprintf{) command reconstructs the date fo the 


form desired by this programer. With the date input, reformated and validated 


we now return to main. We print the reformated date. The next line shows how 
we can use scanf to extract information from the standard form for use in the 

printf() statement on the next line which prints the date in alonghand form. 
Note the "%*" this tells sscanf to skip over the data specified rather than 


assigning it. : 


We leave the rest of the program up to you. You should be able to follow it 
now. 

Now some suggestions for your own experimenting. The function could be 
modified to get the date from the ST keyboard clock. A bios call exists for this. 
You may wish to alter the date format | chose. a . 
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| intentionally left two potential problems in this code. Both involve the user | 
inputing to little information when the date is requested. One is leaving out a 
field such as the year. The other invalving the year. The coding of the 
program will only be valid if a two or four digit year is entered. What changes 
are needed to fix this. — = 7 | ae 

Finally arequest. If you can use what you know or what you are learning to 
develop functions that would be useful to other ST users please send them to us. 


Until Next time - Happy © Programing. 
© Pregraming Tutorial Source Code 


001 #include <stdio..i> 
002 #include <osbind.h> : 


004 #define MAXLEN 80 
G05 #define getkey() Cnecing) 
006 fundef getchar() 
007 #define getchar) Cconing) 
008 define gets(s) Geistr(s) : 
(009 = #define isdigit(c) (©) >= 'O’ && (c} <= 9’ 
010 #define isupper(c) C) >= A’ && {c) <= °Z’) 
O11 #define islower{c) ((c) >= ‘a’ && (c) <= 'Z' 
012 define tolower(c) Gsupper(c) 7 tt ara : {c}) 
013 #define toupper(c) (islower(c) 7? (c)+(A’-'a’) : (c)) 


014 

O15 Getstr(s) 

O16 char “s; 

O17 { | 

018 char Sie + 2]; 
019 afO] = MAXLEN; 


021. sircpy(s,a + 2); 


022 : 7 
023 | 7 | 
02 4 | ¢hat. ©:.6 At hat .t.2 14.4 0.) <= 
{"January”,”"Febuary”,"March",“April®,"May","June", 025 "July", 


"August”,“September","October","November”, "Decembei"}; 
028 #define MONTH (month -1) = 
029 #define YEAR (year + 1900) 


031  Getdate(date) 
032 char “date; 


Ga5, t : 7 o 
034 Pe Date: ")}; 
035 gets | late); 3 
036 heckdate(date); 
037 putchar(\n'); 
038 =} ——— 
039 

040 Checkdate(date} 
041 char‘date; 


042 { | 
043 int month, day, year; 
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044 if{isdigit(date[0])) 








045 sscani(date,“%d",&month): .. 
046 alsa 
047 { 
048 date[O “ene 
049 date} 1 = teens 
050 ' date[2] = tolower(date 
051 fortes month<} aes 
052 if(istrnemp (date, monthalmont 13)) 
053 break; 
054 month++; 
| O55 } 
| O56 nxt _fid(date): 
057 sscani(date,"“%d" &day); 
t 058 nxt _fid{date): 
| 059 sscanf(date, “Ye” »ayear): 
060 year Yo= 100; 
070 if(month < 1 {| month > 12) 
O71 ae err(O,date); 
| 072 Ise if(day < 1|{ day > 31) 
O73 a err{t,date); 
074 else if(day > 28 
| 675 switch(month) 
076 
077 Case 2: 
078 | if(day > 29). 
| O79 dati err(2, er: 
080 else 0 liiday an | 
081 | ffs AR % 4) > 0) ' 
082 i UD BAR % 100) =z 0} && (YEAR % 400) > 0))) 
083 ate_err(3,date): 
| 084 break; ey 
085 case 4: case 6: case 9: case 11: 
O86 if(day > 30) 
| tod date_err(2,date): 
089 | sprinti(date,"%02d-%02d-%02d" month,day, year) : 
090 
094 : | | 
092 nxt_fid{s) 
093. char *s: 
094 | | 
095 
DGe-e:s 2 whitest sty) 
097 
098 stenylé, $ + i); 
099} 
100 
| 401 date_err(err, date) 
| 102 int err; 
103 char *date: 
104° f{ 
105 ne 
106 , 
107 case 0 
108 “eae Month An"); 
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110 cas 


@ 1: 
111 printi(“\ninvalid Day.\n"): 
112 break: 
13 case 2: 
114 rintiC\nTo Many days for entered month.\n"); 
115 reak;: : 
116 case 3: 3 . | 
117 rinti("\nEntered year is not a leap year.\n"); 
118 break: 1 Sie 
119 = default: 
eo printi(\ninvalid date\n’); 
122 Geidate(date); = = 2 eee : 
i 3 | 
124 
125 
26 8 8=6maing 
27 ff | 
128 char c, s{80}, date[30]: 
129 int i, month, Cay. year; 
130 printf(“\n\nin\n This is atest file\n*}; 
131 printi("Type a single character: *); 
132 ¢ = getchar]; - 
133 ean has an ascii value of %d.\n",c); 
134 printi("Enter a line of text: *); 
135 gets(s); , 
136 printi(\nYou Typed %d characters.\n" strlen(s}); 
137 Getdate(date); : 
138 printf("The standard form for the date entered is %s.\n" date); 
39 sscani(date,"%d%"c%d%"*c%d" &month, &day,&ysar); 
140 printf("Expanded it is %s %d, %d.\n"“,monthal[ MONTH] day, YEAR); 
141 printt(\n THANK YOU\n"); 
142 prinif(“\a\nHit return to end: *); 
143 © = getchar(): 





Structured Programing Overview — 


This file is a reprint from ASTUN (Atari ST Users News). 6157 South 700 West Murray, 
Utah 84123 Permission is granted for use of this file in newsletters, BBS's and other non 
commercial uses. We only ask that you give credit fo ASTUN unless the article itself states: > 
it’s origin. [n that case the originating club should be given the credit. in all cases credit : 
should be given to the author. | | 
All modern pene’ languages feature what is known as structured programing. 
This means that the program flaw is simply from top to bottom. The use of statements such | 
as goto are highly discouraged in all structured languages, with some languages expressly _ 
forbidding them by removing the statement from the op code iist.. eoe 2 
The advantages of structured programing are many. The first and greatest {s that 
program flow is straight forward. it's easy for a programer familiar with the language to 
read. {t also, in most cases, produces more efficient code. 
Program documentation is simplified and ofttimes the source code is actually self - 
documenting. Usually the only comments needed are to present the purpose of a program — 
segment. Comments of why a particular line exists is seldom needed. } 
The only disadvantage | know of is that the programer must plan his program in advance. 
Only the very talented programer can sit down at his terminal and produce efficient code 
without a preconceived game plan. This should really be considered an advantage 
however, because a pre-planned program is much easier to construct. 
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Struciured programs are produced in modules. The names of these modules. 
| varies frara language to language but the purpose is the same. A module is a small 
build ng block designed as a pari of a seit program. A series of these modules 
} mans.uo the full pro gram. Each program as a main module that controls the flow. 
| Of 4h program. This main module usuaily cals the other modules in the top down 
fashion described earlier. The cade within this module simply flows from the 
beginning to the end. li may contain various looping techniques but is fashioned 
ith easy flowing code that is very easy to understand. — 

in oraer to accornplish structured eee two types of tools are 
commonly used. One is tloweharting, the other a form of outlining. 

In the outline form a person: oa a program in suto code. Such an outline. 
| ofttimes has similarities to actual codes. Short keywords or sentences construct | 
the pregram : flow. . 

«ii we are to write 2 program that will sort a list of phone numbers | in numeric 
order our outline may look similar to this examole. 

Obtain File containing phone numbers: 

Read file into an array ; 

Sort the numbers in numeric order ais 

Print the numbers anto the ert. 


It may be necessary to also create an outline for es of the major modules . 
discussed in the outline. | An example (Bubble sort the — in numeric order) 


Get first array element — 

Get second array element 

Check to see which is larger - 
if the first is larger copy tito a temporary variable, then =. the second into 
the first, finally copy the temporary variable to second posit 
Get the third element and compare it with the second. ff oe follow the 
same procedure as with this first two elements. 
Continue to perform these operatigns in successive order until there are no 
more numbers in the fist. | 
Repeat t'as entire process until no variable swaying takes place. 

Experienced programers ofttimes do not need to ga to such detail and the main 


Dey outline may be all that is needed. Beginners should outline the main flow | 


as well as the flow within the modules. Some very talented pragramers may be 
able to mentally perform this process. Most must document their thoughts. 
Now a flow charting example. Usually flowcharts are more detailed than 


outlines and, for — easier to follow. Programs are represented by a block | 


diagram structure. — represent various program modules, 
; Our example wiil be to look up a telephone number for a specific person. A 
tile exists on the computer containing names and poche numbers of several 


| people. 
| Look-up Fone Number | 
| Get Kans to Look up] 


(an a . 
See aud No 


sili Sa ae load 

/Does\ | ‘Last\ 
fRecord\ sad 
— 

\{ pies. 


_(play'Recora | mo d| 
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process symbol (rectangle) and a decision symbol (diamond). Flowchart 
templates are available at various computer and electronics stores containing 
additional symbols and their meaning. 

The sample flowchart follows the structured rules of top down fashion. A 
loop is ——- and easily seen within the flowchart. Arrows are used to indicate 
program flow. és 

| have heard people say that it is impossible to program without branching. |! 
have to both agree and disagree with them. I strongly beliove however that 
branching using goto’s should be avoided. Only in very special circumstances 
should it be used. A call of a module is similar to a gosub but not called that. In 
structured programing you are simply calling a function. The function name, if 
good structure is followed, represents the task performed. The properties of the 
anguage provide the required calls. Outside of function or module calls all forms 
| Of branching can be performed by looping. Looping is much better because the 
| program flow remains. No fooking from one end of a program to the other is 
needed in order to find out what is going on. | 

Once you have decided how you will organize your program the rest is to 
| keep things if perspective. The lines related to a comparison are indented from 
the test line to indicate they are related to the test. The same is true for looping 
statements. This makes it possible for the person reading the code to relate to 
exactly what is happening-interpreted Basic does not offer this flexibility. Most 
compiled languages do even if they were originally designed as a structured 
ey All recent language developments a redesigned to be structured. 

will demonstrate this technique using a suto language. 


Start Program 
Display Menu 
Get optian 
if option = sort 
execute sort 
Else if option = lookup - 
Get name to be looked up 
Open Record 
Until End of File 
Read record 
Hf End of file E 
Print Error Message 
lf Match 
Print record 


se 
Print Error Message 
End Program 


This example is intended as a simple example. You will note however, that 
the outline even without program comments can be followed. You simply begin at 
the top and move down the program. A loop is includad to show how it does nat 
deteriorate the flow. A good structured program can be followed as easy as this 
suto outline presented here. : 

The external module sort would be constructed with the same type of 
indentation. As an exercise try to take the bubble sort suto program outline 
presented earlier and piace it into a structured form. 


| have intentionally used suto.examples —_ Ralph Porter 
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~ TOS ERROR CODES © 


0 OK. (no problems.) 

1 GENERAL ERROR. 

2 DRIVE NOT READY. Device was not ready, attached or has been 
busy too long: 

3 UNKNOWN COMMAND. Device did not understand you. 

4 CRC ERROR. Soft read error. 7 

5 BAD REQUEST. Device could not handie the command, although it 
understood it. Check your system parameters. 

6 SEEK ERROR. Drive could not preform a seek. 

7 UNKNOWN MEDIA. Attempt to read unformatted or — media. 

Usually caused by a trashed or zeroed boot sector. 

8 SECTOR NOT FOUND. The requested sector could not be found. 

9 NO PAPER. The printer is out of paper. 

10 WRITE FAULT. A write operation failed. 

11 READ FAULT. A read operation failed. 

12 GENERAL MISHAP. Resurved for future errors. | 

13 WRITE PROTECT. You attempted to write to a write-protected disk. 

14 MEDIA CHANGE. The media has been changed since the last write. 

15 UNKNOWN DEVICE. The operation specified a device that BIOS 

could not recognize. 
16 BAD SECTORS. A format operation detected bad sectors.. 


17 INSERT-DISK. A request for you to insert a disk. 


GEMDOS CODES 
NEXT MONTH 


& a8 
Re Eee, 
i 
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(C-SYSTEMS 


3724 Kentucky Drive (Box 333) - 
West Jordan, Utah 84084 _ 


ATARI SErnCe SPECIALISTS 


Competive Pricing for all services. 


System Upgrades and Modifications 


Memory Upgrades — 


One Meg Upgrade SS $85 
Two point five Meg Upgrade $495 ; 
Four Meg Upgrade $895 | it 


Double Sided Disk Drives 


single Drive $249 Post Paid 
Double Drive $449 Post Paid 





Single Drive now has dasy chain connector for second drive. © 
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